popover: Fix documentation blurb

The grabbing behavior is no longer exclusively controlled by the caller,
mention gtk_popover_set_modal().

diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c
index 258c3144beaacd993f359efe6d6f5d0eb57fb737..59d9fe59b65f29bd21fc77f1b2fb7df4b33a751c 100644 (file)
--- a/gtk/gtkpopover.c
+++ b/gtk/gtkpopover.c
@@ -30,8 +30,14 @@
  * The position of a popover relative to the widget it is attached to
  * can also be changed through gtk_popover_set_position().
  *
- * By default, no grabs are performed on #GtkPopover<!-- -->s, if a
- * modal behavior is desired, a GTK+ grab can be added with gtk_grab_add()
+ * By default, #GtkPopover performs a GTK+ grab, in order to ensure
+ * input events get redirected to it while it is shown, and also so
+ * the popover is dismissed on the expected situations (clicks outside
+ * the popover, or the Esc key being pressed). If no such modal behavior
+ * is desired on a popover, gtk_popover_set_modal() may be called on it
+ * to tweak its behavior.
+ *
+ * Since: 3.12
  */
 
 #include "config.h"